BBS Toolkit/BBS Toolkit.iso/doors_1/dice30.zip/DICE.DOC

Text File | 1991-06-29 | 15KB | 528 lines

                 ┌────────────────────────────────────────────┐
                 │                                            │
                 │                 TURBO DICE                 │
                 │           =======================          │
                 │                                            │
                 │         A Live Game for Many BBS's         │
                 │                                            │
                 │   Game Release Version 3.0 - 01/01/91      │
                 │                                            │
                 │             (C)opyright 1990               │
                 │                                            │
                 │                   By                       │
                 │                                            │
                 │            SECRET SERVICE BBS              │
                 │                                            │
                 │              Mike Wilson                   │
                 │              P.O. Box 9521                 │
                 │            Huntington, WV                  │
                 │                  25704                     │
                 │                                            │
                 │            BBS [phone]              │
                 │            1200/2400/9600 24 hrs.          │
                 │                                            │
                 │                                            │
                 │                                            │
                 │                                            │
                 └────────────────────────────────────────────┘

























                     Turbo Dice  (C)opyright 1990 - Page 1









                                  Warranty


This is product is provided "as is" without warranty of any kind.  The
entire risk as to the results and performance of the program is assumed by
you. Futher more, I the author do not warrant, guarantee, or make any
representations regarding the use of, or the results of the use of the program,
and you rely on the program and results solely at your own risk.  I the author
cannot accept responsibility for system damage, loss of profit, or any other
special, incidental, or consequential damages resulting from the use or
inability to use this product.


                                 Copyright


The multi-board Turbo Dice live game is distributed as SHAREWARE.
Under this concept you may use the SHAREWARE (unregistered) version for a
reasonable period of time, which I consider to be three weeks, after which you
must either register your copy or discontinue usage.


                               Registration

With registration you will recieve the latest registered copy of Turbo
Dice with the ability to download any futher updates from Secret Service BBS
at no extra  cost. You will also recieve any support the author can give
in reference to bugs or other problems that may arise in using the game.

I feel that sysop's have enough expense without charging a high cost for a game
for their users. I have set the cost of registration at $15.00 which I feel
if people will follow the shareware concept will be enough to cover shipping
and handling and encourage me to write more doors.
See registration.txt in the .zip  for ordering instructions.


                               Distribution

You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)
version of The Multi-board Turbo Dice Live Game provided that all files
contained in the original Turbo Dice archive are distributed in their
original unmodified state.














                   Turbo Dice  (C)opyright 1990 - Page 2



                               Introduction
                                     &
                                How To Play


Turbo Dice is the Dice version of the popular card game.  You are
presented with three rows of dice and you must place bets on whether the
next dice rolled will be higher or lower than the currently displayed dice.
On the last roll a player must bet at least half of his account.
A player may re-roll dice one time per row in order to try to obtain a
better dice to bet against.


                          Options and Information

This door game will also create color and mono top 10 bulletins and write them
in directories of your choice written in the .CFG file. The top player of the
previous month is displayed within the bulletins as well as the all time
high scorer.



                            Installation and Setup

Make a directory on your hard drive and unzip Dice.zip into it.
Run the program Setup.exe and answer the questions as they appear.
If your only running one node then thats about all there is to it!
Read the Batch file setup of the docs to see how to call the game
from your board.

Setup,exe creates a Dice.cfg (for one node) and a board.txt file
(if not a wildcat system).

The following describes each file:


Dice.cfg contains:

The Secret Service BBS           <-- Name of BBS
Mike                             <-- Sysop's first name
Wilson                           <-- Sysop's last name
C:\BBS\doorinfo.???          <-- Path and filename for BBS info (see below)
C:\BBS\Bulletin\Bullet30.Scr <-- Path & Filename to create COLOR bulletin
C:\BBS\Bulletin\Bullet30.bbs <-- Path & Filename to create MONO bulletin
NO                               <-- NO or locked COM PORT Baud Rate


*** Note: The above line that refers to BBS info. file will be based on
your particular board software.

 WILDCAT prior to V3.0 -----> CALLINFO.BBS     PCBOARD ---> PCBOARD.SYS
 GAP or WILDCAT 3.0+--------> DOOR.SYS         SPITFIRE --> SFDOORS.DAT
 QUICKBBS ---> DoorinfoX.def (The X is 1 or 2 depending on node)

A proper example of path and filename for BBS info file would be:
                      C:\Wildcat\Callinfo.bbs

The path and filenames of color and mono bulletins can be any legitimate
path and Dos file name. Its wherever you want the bulletins written and
what you want to call them.


                Turbo Dice  (C)opyright 1990   Page - 3


NOTE FOR MULTI NODES!
You may now have several .cfg files to allow use on multinode systems.
Use the above .cfg format but name each .cfg file differently. You
may call them what you want as long as you correctly call them from
the batch file command line.

Example:    Node1:     game game.cfg

            Node2:     game game1.cfg

** If you need non-standard IRQ's or COM Addresses for Multi-nodes read
   the file Port.doc!

DICE.DAT contains:

This file contains the following user data:

"The Champion","10-29-1990","100"

Data has to be kept in this format, but you can delete all lines except for
line number 1 which is the Last Months Champ line. You can alter line 1 but
not remove it. You need to alter line 1's Date form 01-12-1990 to the month
that your setting up this door. For example if it is December just simply
change the Date to 12-01-1990. It doesn't matter if it's the 1st or the 10th,
only the Month (12) will make any difference.


Dice.TXT contains:

This is the instruction file for Turbo Dice. When a user selects the
See Instructions option during the game, this file is read for
instructions. This file MUST BE PRESENT and Not altered in any way for
Turbo Dice to run properly



                          List of Files In Archive

The following files are either found in your Turbo Dice .ZIP or will be
created during the runtime execution of the game.


DICE.EXE    <--- Executable Program.

SETUP.EXE   <--- Setup File for Game

DICE.DAT    <--- Store User's Name, Last Play Date & Score.

DICE.TXT    <--- Instructions Used By Program.

BULLET##.SCR *<--- COLOR Bulletin

BULLET##.BBS *<--- MONO Bulletin

DICE.DOC    <--- This File.

Champion.txt <--- The file that stores the all time champion score

Register.txt <--- Registration form for Mike Wilson games

* DENOTES that file is created during RUN-TIME.


                Turbo Dice  (C)opyright 1990  Page - 4


BOARD.TXT
---------

Don't worry about this file if you run Setup.exe it creates it!
The setup file will create a one line ASCII file called Board.txt
(if you are not running Wildcat.) If your running Wildcat prior to
ver. 3.0 there should be NO Board.txt file in the game directory.
For boards other than Wildcat! board.txt will exist in the game
directory and will have one line with one of the following on it:

For QuickBBS --------------> QBBS     For Spitfire-->SPITFIRE
For GAP or Wildcat 3.0+ ---> GAP      For PCBoard -->PCB




                                  Batch Files
                               =================


Be sure that you have edited or created the Dice.cfg file with the correct
information as described earlier in these docs. The individual setups do not
repeat this necessary process.



Wildcat! 1.13 & 2.0+ Setup:
---------------------------
First, create your DOOR##.BAT (2.0+) or LIVE##.BAT (1.13) like this eample:

   ECHO OFF
   CD \WILDCAT\DOORS\DICE
   DICE DICE.CFG
   CD \WILDCAT
   CAT.BAT

place this batch file in your Node# directory if running Multi-Nodes or in
your Wildcat (default) directory if single node.

Second, Create a sub-directory for the door program such as in the following
example:

C:\WILDCAT\DOORS\DICE

Third, put the Turbo Dice game files in the \WILDCAT\DOORS\DICE directory.

Forth, add this game to your live program menu for user selection and your
ready to run the door.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.


Gap Setup:
----------
First, add the number and name of the door to your menu. This will allow the
user to select the door by number.



                  Turbo Dice  (C)opyright 1990  Page - 5

Second, edit or create the file called DOORS.DAT which is normally in the GEN
directory. Following is an example line to add:

   TD 10

where 'TD' stands for the name of the batch file (shown below) to invoke the
the door and '10' is the required security level.

Third, create a sub-directory for Turbo Dice to be placed in. And example
would be:

C:\GAP\DICE

place all the files in the DICE.ZIP archive inside this directory.

Forth, create a batch file called DICE which should be placed in the
default directory. Following is example contents of this file:

   ECHO OFF
   CD\GAP\DICE
   DICE DICE.CFG
   CD\GAP
   GAP

the last line in the DICE file should invoke the batch file which loads
the GAP BBS system.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.


Spitfire Setup:
---------------
First edit your SFDOOR.MNU and add the following line. If you are not running
and doors at this time you will need to create this file.

   TURBODICE, 10

   Where TURBO DICE is the name of the door to appear on your menu and the 10
   is the lowest security level that will be allowed to enter the door. Don't
   forget the comma (,) after the name.

Second create a sub-directory to place the door game in. In this example we
will use 'C:\SF\DOOR_A' for the game directory.

Third move all the files in the DICE.ZIP archive into this directory.

Forth edit your SF.BAT file adding the following lines.

:DOOR_A
   CD\SF\DOORS_A
   DICE DICE.CFG
   CD\SF
   GOTO LOOP

Fifth, rerun Sf.BAT and your ready to begin play.

If this is a little unclear then please read your systems documentation for
more detailed instructions.


             Turbo Dice  (C)opyright 1990    Page - 6


If you use a door monitoring program then read their documentation for
their specific setup.


PCBoard 14.0+ Setup:
--------------------
First, edit your DOORS and DOORSG file so that it shows Turbo Dice with the door
number relating to it's position in DOORS.DAT.

Second, edit the DOORS.DAT file so that it includes Turbo Dice.

Third, create a sub-directory for Soli-Tree to be placed in. And example
would be:

C:\PCB\DICE

place all the files in the DICE.ZIP archive inside this directory.

Forth, create a batch file called DICE which should be placed in the
default directory. Following is example contents of this file:

   ECHO OFF
   CD\PCB\DICE
   DICE DICE.CFG
   CD\PCB
   BOARD

the last line in the DICE file should invoke the batch file which loads
the PCboard BBS system.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.


QuickBBS Setup:
---------------
First, add the game to your games menu and select the correct type for doors.

Second, create a sub-directory for the game and move all the files from the
zip file to this directory.

Third, the game reads the file DORINFOx.DEF. Where 'x' is the node number.
Since QuickBBS only supports one node at this time then this file should be
'DORINFO1.DEF'. This file's drive\path\filename should be on the third line
of the configuration file.

   Note: It was told to me that the upcoming 3.0 version of QucikBBS will
         support Multi-Nodes and that the 'DORINFOx.DEF' will be changed
         to 'DORINFxx.DEF' to support Multi-Nodes. This game is written
         where you can specify this new name as well as any others.

Forth, create a batch file called DICE which should be placed in the
default directory. Following is example contents of this file:

   ECHO OFF
   CD\QUICKBBS\DICE
   DICE DICE.CFG
   CD\QUICKBBS
   QBBS.BAT

                 Turbo Dice  (C)opyright 1990  Page - 7

the last line in the DICE file should invoke the batch file which loads
the QuickBBS system.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.



                            Technical Support

If you have problems with the Multi-Board Turbo Dice live game you may
contact Mike Wilson at the Secret Service BBS 24 hours per day.






                              Order Information


Just mail $15.00 Check or Money Order or Cash to:

MASTERCARD and VISA also welcome!

Mike Wilson
P.O. Box 9521
Huntington, WV
            25704

Make Checks out to Mike Wilson.
All funds U.S.!

Special thanks to Jeff Sumberg for some great C routines used in this game!



























                     Turbo Dice (C)opyright 1990 - Page 8